ИМЯ¶

opendir, fdopendir - открывает каталог

ОБЗОР¶

#include <sys/types.h>


#include <dirent.h>

DIR *opendir(const char *name);
DIR *fdopendir(int fd);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

fdopendir():

ОПИСАНИЕ¶

Функция opendir() открывает поток каталога, соответствующий каталогу с именем name, и возвращает указатель на поток каталога. Поток устанавливается на первую запись в каталоге.

Функция fdopendir() похожа на opendir(), но возвращает поток каталога для каталога, на который ссылается открытый файловый дескриптор fd. После успешного вызова fdopendir(), дескриптор fd используется только внутри реализации и не должен использоваться в приложении.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

Функции opendir() и fdopendir() возвращают указатель на поток каталога. В случае ошибки возвращается NULL, а errno присваивается соответствующее значение.

ОШИБКИ¶

EACCES

Доступ запрещен.

EBADF

Значение fd не является подходящим файловым дескриптором, открытым для чтения.

EMFILE

Процессом задействовано слишком много файловых дескрипторов.

ENFILE

В системе в настоящий момент открыто слишком много файлов.

ENOENT

Каталог не существует, либо name содержит пустую строку.

ENOMEM

Недостаточно памяти для завершения операции.

ENOTDIR

Значение name не является каталогом.

ВЕРСИИ¶

Функция fdopendir() доступна в glibc начиная с версии 2.4.

СООТВЕТСТВИЕ СТАНДАРТАМ¶

Функция opendir() присутствует в SVr4, 4.3BSD и описана в стандарте POSIX.1-2001. Функция fdopendir() описана в POSIX.1-2008.

ЗАМЕЧАНИЯ¶

Задействованный файловый дескриптор потока каталога может быть получен в помощью dirfd(3).

Функция opendir() устанавливает флаг close-on-exec для файлового дескриптора, указывающего на DIR *. Функция fdopendir() оставляет флаг close-on-exec не изменённым для файлового дескриптора fd. В POSIX.1-200x нет точного определения на этот счет, хотя успешный вызов fdopendir() установит флаг close-on-exec для файлового дескриптора fd.

СМОТРИТЕ ТАКЖЕ¶

open(2), closedir(3), dirfd(3), readdir(3), rewinddir(3), scandir(3), seekdir(3), telldir(3)